Skip to main content
Version: 1.0.16

ALTER POLICY

ALTER POLICY — Change the Definition of a Row-Level Security Policy

Synopsis

ALTER POLICY name ON table_name RENAME TO new_name

ALTER POLICY name ON table_name

[ TO { role_name | PUBLIC | CURRENT_USER | SESSION_USER } [, ...] ]

[ USING ( using_expression ) ]

[ WITH CHECK ( check_expression ) ]

Description

ALTER POLICY changes the definition of an existing row-level security policy. Note that ALTER POLICY only allows modifying the set of roles that the policy applies to, and the USING and WITH CHECK expressions. To change other attributes of the policy, such as:

the commands it applies to, or whether it is permissive or restrictive, you must drop and recreate the policy.

To use ALTER POLICY, you must own the table that the policy applies to.

In the second form of ALTER POLICY, if the role list, using_expression, and check_expression are specified, they are replaced independently. When one of these clauses is omitted, the corresponding part of the policy is not changed.

Parameters

name

The name of an existing policy to alter.

table_name

The name (optionally schema-qualified) of the table that the policy is on.

new_name

The new name of the policy.

role_name

The role(s) to which the policy applies. Multiple roles can be specified at once. To apply the policy to all roles, use PUBLIC.

using_expression

The USING expression for the policy. See CREATE POLICY for details.

check_expression

The WITH CHECK expression for the policy. See CREATE POLICY for details.

See Also

CREATE POLICY,DROP POLICY